Inside Macintosh: Telephony /

Chapter 2 - Telephone Terminals / Telephone Terminals Reference

Telephone Terminals Functions / Monitoring and Controlling Telephone Terminals

TELSetIndHSConnect

Sets the connection state of a telephone handset.

pascal TELErr TELSetIndHSConnect (TELHandle termHand, Boolean Connect);

termHand

A handle to a telephone record associated with a telephone terminal.

Connect

A Boolean value that indicates whether the specified telephone handset is to be connected (telIndHSConnected) or disconnected (telIndHSDisconnected).

function result

A result code.

DESCRIPTION

The TELSetIndHSConnect function connects or disconnects the telephone handset specified by the termHand parameter. If Connect is telIndHSConnected, the handset is connected to the phone line; otherwise, the handset is disconnected from it.

When the handset is connected to the phone line, the user is able to dial out directly from the handset without requiring application intervention. When the handset is disconnected from the line, all handset activity is directed to the computer (for example, all DTMF tones are simply passed up to the application and are not automatically forwarded on the phone line).